gh-133510: Add links to more info for the match statement by xzkdeng · Pull Request #133511 · python/cpython

xzkdeng · 2025-05-06T12:51:12Z

Add example of the match statement in the FAQ "Why isn't there a switch or case statement in Python?", and links to PEP 634,PEP 636 for details.

Issue: No links to more info for the match statement in the faq #133510

📚 Documentation preview 📚: https://cpython-previews--133511.org.readthedocs.build/

Add example of the ``match`` statement in the FAQ "Why isn't there a switch or case statement in Python?", and links to PEP 634,PEP 636 for details.

python-cla-bot · 2025-05-06T12:51:16Z

All commit authors signed the Contributor License Agreement.

Co-authored-by: sobolevn <mail@sobolevn.me>

StanFromIreland · 2025-05-06T15:51:37Z

+
 Since Python 3.10 one can easily match literal values, or constants
 within a namespace, with a ``match ... case`` statement.
+See :pep:`634` (specification) and :pep:`636` (tutorial) for details about the ``match`` statement.


For the "(tutorial)" it is probably best to replace the link with a link to the actual tutorial page that covers this.

Agreed. The PEPs are historical documents that typically become stale over time. I think that there shouldn't be a link to a PEP for either the specification or tutorial.

So we should add an 'outdated' note in PEP 636, like the one in PEP 634.

Co-authored-by: sobolevn <mail@sobolevn.me>

AA-Turner · 2025-05-07T13:46:15Z

+
 Since Python 3.10 one can easily match literal values, or constants
 within a namespace, with a ``match ... case`` statement.
+See :pep:`634` (specification) and :pep:`636` (tutorial) for details about


Please link to the documentation too here.

Did you mean adding a link to this?

bedevere-app · 2025-05-07T13:46:25Z

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

Changed the links to link to more up-to-date documentation.

xzkdeng · 2025-05-09T11:15:33Z

I have made the requested changes; please review again
Suggestions are welcomed!

bedevere-app · 2025-05-09T11:15:38Z

Thanks for making the requested changes!

@AA-Turner: please review the changes made to this pull request.

xzkdeng · 2025-05-09T11:18:22Z

Accidentally clicked the "close with comment" button.

github-actions · 2026-04-24T06:38:25Z

This PR is stale because it has been open for 30 days with no activity.

read-the-docs-community · 2026-06-29T13:20:25Z

Documentation build overview

📚 cpython-previews | 🛠️ Build #33355690 | 📁 Comparing d3ca02d against main (0cbac06)

🔍 Preview build

1 file changed

± faq/design.html

miss-islington-app · 2026-06-30T09:08:57Z

Thanks @xzkdeng for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13.
🐍🍒⛏🤖

miss-islington-app · 2026-06-30T09:08:57Z

Thanks @xzkdeng for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.14.
🐍🍒⛏🤖

miss-islington-app · 2026-06-30T09:08:57Z

Thanks @xzkdeng for the PR, and @StanFromIreland for merging it 🌮🎉.. I'm working now to backport this PR to: 3.15.
🐍🍒⛏🤖

bedevere-app · 2026-06-30T09:09:10Z

GH-152654 is a backport of this pull request to the 3.13 branch.

bedevere-app · 2026-06-30T09:09:15Z

GH-152655 is a backport of this pull request to the 3.14 branch.

bedevere-app · 2026-06-30T09:09:22Z

GH-152656 is a backport of this pull request to the 3.15 branch.

…AQ anwser (GH-133511) (#152654) (cherry picked from commit 7718157) Co-authored-by: xzkdeng <xzkdeng@gmail.com> Co-authored-by: sobolevn <mail@sobolevn.me> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Stan Ulbrych <stan@python.org>

…AQ anwser (GH-133511) (#152655) (cherry picked from commit 7718157) Co-authored-by: xzkdeng <xzkdeng@gmail.com> Co-authored-by: sobolevn <mail@sobolevn.me> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Stan Ulbrych <stan@python.org>

…AQ anwser (GH-133511) (#152656) (cherry picked from commit 7718157) Co-authored-by: xzkdeng <xzkdeng@gmail.com> Co-authored-by: sobolevn <mail@sobolevn.me> Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com> Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> Co-authored-by: Stan Ulbrych <stan@python.org>

Add example for the match statement

d377b8c

Add example of the ``match`` statement in the FAQ "Why isn't there a switch or case statement in Python?", and links to PEP 634,PEP 636 for details.

bedevere-app Bot added docs Documentation in the Doc dir skip news labels May 6, 2025

bedevere-app Bot mentioned this pull request May 6, 2025

No links to more info for the match statement in the faq #133510

Closed

bedevere-app Bot added the awaiting review label May 6, 2025

github-project-automation Bot added this to Docs PRs May 6, 2025

github-project-automation Bot moved this to Todo in Docs PRs May 6, 2025

sobolevn reviewed May 6, 2025

View reviewed changes

Comment thread Doc/faq/design.rst Outdated

Comment thread Doc/faq/design.rst Outdated

Comment thread Doc/faq/design.rst Outdated

xzkdeng and others added 3 commits May 6, 2025 21:08

Update Doc/faq/design.rst,by suggestion of sobolevn -1

08674f4

Co-authored-by: sobolevn <mail@sobolevn.me>

Update Doc/faq/design.rst,by suggestion of sobolevn -2

0fe1843

Co-authored-by: sobolevn <mail@sobolevn.me>

Update Doc/faq/design.rst,by suggestion of sobolevn -3

eb54817

xzkdeng changed the title ~~gh-133510: Add example for the match statement~~ gh-133510: Add links to more info for the match statement May 6, 2025

sobolevn reviewed May 6, 2025

View reviewed changes

Comment thread Doc/faq/design.rst Outdated

StanFromIreland reviewed May 6, 2025

View reviewed changes

Comment thread Doc/faq/design.rst Outdated

StanFromIreland reviewed May 6, 2025

View reviewed changes

Nneoma00 mentioned this pull request May 7, 2025

gh-133510: Added Resources section #133559

Closed

Update Doc/faq/design.rst

804c8a3

Co-authored-by: sobolevn <mail@sobolevn.me>

AA-Turner requested changes May 7, 2025

View reviewed changes

bedevere-app Bot added awaiting changes and removed awaiting review labels May 7, 2025

xzkdeng and others added 2 commits May 9, 2025 18:51

Update Doc/faq/design.rst,by suggestions -1

05a62ee

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

Update design.rst according to suggestions -2

184c150

Changed the links to link to more up-to-date documentation.

xzkdeng closed this May 9, 2025

bedevere-app Bot added awaiting change review and removed awaiting changes labels May 9, 2025

bedevere-app Bot requested a review from AA-Turner May 9, 2025 11:15

StanFromIreland reviewed Sep 5, 2025

View reviewed changes

Comment thread Doc/faq/design.rst Outdated

github-actions Bot added the stale Stale PR or inactive for long period of time. label Apr 24, 2026

Apply suggestion from @StanFromIreland

6e81955

StanFromIreland reviewed Jun 29, 2026

View reviewed changes

Comment thread Doc/faq/design.rst Outdated

StanFromIreland added 2 commits June 29, 2026 15:13

Apply suggestion from @StanFromIreland

320a5c1

Merge branch 'main' into main

d3ca02d

StanFromIreland approved these changes Jun 29, 2026

View reviewed changes

bedevere-app Bot added awaiting merge and removed awaiting change review labels Jun 29, 2026

StanFromIreland merged commit 7718157 into python:main Jun 30, 2026
33 of 34 checks passed

github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 30, 2026

bedevere-app Bot removed the awaiting merge label Jun 30, 2026

StanFromIreland added needs backport to 3.13 bugs and security fixes needs backport to 3.14 bugs and security fixes needs backport to 3.15 pre-release feature fixes, bugs and security fixes labels Jun 30, 2026

bedevere-app Bot removed the needs backport to 3.13 bugs and security fixes label Jun 30, 2026

bedevere-app Bot removed the needs backport to 3.14 bugs and security fixes label Jun 30, 2026

bedevere-app Bot removed the needs backport to 3.15 pre-release feature fixes, bugs and security fixes label Jun 30, 2026

Uh oh!

Uh oh!

Conversation

xzkdeng commented May 6, 2025 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

python-cla-bot Bot commented May 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

StanFromIreland May 6, 2025

Choose a reason for hiding this comment

Uh oh!

ericvsmith May 6, 2025

Choose a reason for hiding this comment

Uh oh!

xzkdeng May 9, 2025

Choose a reason for hiding this comment

Uh oh!

AA-Turner May 7, 2025

Choose a reason for hiding this comment

Uh oh!

xzkdeng May 9, 2025

Choose a reason for hiding this comment

Uh oh!

bedevere-app Bot commented May 7, 2025

Uh oh!

xzkdeng commented May 9, 2025

Uh oh!

bedevere-app Bot commented May 9, 2025

Uh oh!

xzkdeng commented May 9, 2025

Uh oh!

Uh oh!

github-actions Bot commented Apr 24, 2026

Uh oh!

Uh oh!

read-the-docs-community Bot commented Jun 29, 2026

Documentation build overview

Uh oh!

Uh oh!

miss-islington-app Bot commented Jun 30, 2026

Uh oh!

miss-islington-app Bot commented Jun 30, 2026

Uh oh!

miss-islington-app Bot commented Jun 30, 2026

Uh oh!

bedevere-app Bot commented Jun 30, 2026

Uh oh!

bedevere-app Bot commented Jun 30, 2026

Uh oh!

bedevere-app Bot commented Jun 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

xzkdeng commented May 6, 2025 •

edited by github-actions Bot

Loading

python-cla-bot Bot commented May 6, 2025 •

edited

Loading